home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / gnu / texinfo.lha / texinfo-3.1 / NEWS < prev    next >
Text File  |  1993-05-21  |  10KB  |  320 lines
  1. Changes between Texinfo 3.0 and 3.1:
  2.  
  3. Just bug fixes, see ChangeLog for full details. 
  4.  
  5.  
  6.  
  7.  
  8. Texinfo 2
  9. *********
  10.  
  11. The second edition of the Texinfo manual is now released in a package
  12. with the second version of the various Texinfo support files,
  13. including `texinfo.el', `texnfo-upd.el', and `makeinfo.c'.  The new
  14. manual is considerably larger than the previous one.
  15.  
  16. Here is a brief description of the new Texinfo mode commands 
  17. and the newly described @-commands:
  18.  
  19. New Texinfo Mode Commands
  20. =========================
  21.  
  22. Texinfo mode provides commands and features especially designed for
  23. working with Texinfo files.  More than 20 new commands have been
  24. added, including commands for automatically creating and updating both
  25. nodes and menus.  This is a tedious task when done by hand.
  26.  
  27. The keybindings are intended to be somewhat mnemonic.
  28.  
  29. Update everything
  30. -----------------
  31.  
  32. The `texinfo-master-menu' command is the primary command:
  33.  
  34.      C-c C-u m       Create or update a master menu.
  35.                      With an argument, first create or
  36.                      update all nodes and regular menus.
  37.  
  38. Update Pointers
  39. ---------------
  40.  
  41. Create or update `Next', `Previous', and `Up' node pointers.
  42.  
  43.      C-c C-u C-n     Update a node.
  44.      C-c C-u C-e     Update every node in the buffer.
  45.  
  46. Update Menus
  47. ------------
  48.  
  49. Create or update menus.
  50.  
  51.      C-c C-u C-m     Make or update a menu.
  52.  
  53.      C-c C-u C-a     Make or update all the menus
  54.                      in a buffer; with an argument, 
  55.                      first update all the nodes.
  56.  
  57. Insert Title as Description
  58. ---------------------------
  59.  
  60. Insert a node's chapter or section title in the space for the
  61. description in a menu entry line; position point so you can edit the
  62. insert.  (This command works somewhat differently than the other
  63. insertion commands, which insert only a predefined string.)
  64.  
  65.      C-c C-c C-d     Insert title.
  66.  
  67. Format for Info
  68. ---------------
  69.  
  70. Provide keybindings both for the Info formatting commands that are
  71. written in Emacs Lisp and for `makeinfo' which is written in C.
  72.  
  73. Use the Emacs lisp `texinfo-format...' commands:
  74.  
  75.      C-c C-e C-r     Format the region.
  76.      C-c C-e C-b     Format the buffer.
  77.  
  78. Use `makeinfo':
  79.  
  80.      C-c C-m C-r     Format the region.
  81.      C-c C-m C-b     Format the buffer.
  82.      C-c C-m C-l     Recenter the `makeinfo' output buffer.
  83.      C-c C-m C-k     Kill the `makeinfo' formatting job.
  84.  
  85. Typeset and Print
  86. -----------------
  87.  
  88. Typeset and print Texinfo documents from within Emacs.
  89.  
  90.      C-c C-t C-r     Run TeX on the region.
  91.      C-c C-t C-b     Run TeX on the buffer.
  92.      C-c C-t C-i     Run `texindex'.
  93.      C-c C-t C-p     Print the DVI file.
  94.      C-c C-t C-q     Show the print queue.
  95.      C-c C-t C-d     Delete a job from the print queue.
  96.      C-c C-t C-k     Kill the current TeX formatting job.
  97.      C-c C-t C-x     Quit a currently stopped TeX formatting job.
  98.      C-c C-t C-l     Recenter the output buffer.
  99.  
  100. Other Updating Commands
  101. -----------------------
  102.  
  103. The `other updating commands' do not have standard keybindings because
  104. they are less frequently used.
  105.  
  106.      M-x texinfo-insert-node-lines
  107.                      Insert missing node lines using 
  108.                      section titles as node names.
  109.  
  110.      M-x texinfo-multiple-files-update
  111.                      Update a multi-file document.
  112.  
  113.      M-x texinfo-indent-menu-description
  114.                      Indent descriptions in menus.
  115.  
  116.      M-x texinfo-sequential-update-node
  117.                      Insert node pointers in strict sequence.
  118.  
  119. Newly Described Texinfo @-Commands
  120. ==================================
  121.  
  122. The second edition of the Texinfo manual describes more than 50
  123. commands that were not described in the first edition.  A third or so
  124. of these commands existed in Texinfo but were not documented in the
  125. manual; the others are new.  Here is a listing, with brief
  126. descriptions of them:
  127.  
  128.  
  129. Commands for creating your own index and for merging two indices:
  130.  
  131. `@defindex INDEX-NAME'
  132.      Define a new index and its indexing command.  Print entries in a
  133.      roman font.  Also, the `@defcodeindex' command, which prints
  134.      entries in an `@code' font.
  135.  
  136. `@synindex FROM-INDEX INTO-INDEX'
  137.      Merge the index named in the first argument into the index named
  138.      in the second argument.  Sets FROM-INDEX in the same (roman) font
  139.      as INTO-INDEX.  Also, the `@syncodeindex' command, which prints
  140.      the entries from the first index in `@code' font.
  141.  
  142.  
  143. Many commands to help you describe functions, variables, macros,
  144. commands, user options, special forms and other such artifacts in a
  145. uniform format.
  146.  
  147. `@deffn CATEGORY NAME ARGUMENTS...'
  148.      Format a description for functions, interactive commands, and
  149.      similar entities that may take arguments.  Takes as arguments the
  150.      category of entity being described, the name of this particular
  151.      entity, and its arguments, if any.
  152.  
  153. `@defvr, @defop, ...'
  154.      15 other related commands.
  155.  
  156.  
  157. Special symbols to indicate the results of evaluation or an expansion,
  158. printed output, an error message, equivalence of expressions, and the
  159. location of point.
  160.  
  161. `@equiv{}'
  162.      Indicate the exact equivalence of two forms; special glyph: `=='.
  163.  
  164. `@error{}'
  165.      Indicate that the following text is an error message: `error-->'.
  166.  
  167. `@expansion{}'
  168.      Indicate the result of a macro expansion; special glyph: `==>'.
  169.  
  170. `@point{}'
  171.      Indicate the position of point; special glyph: `-!-'.
  172.  
  173. `@print{}'
  174.      Indicate printed output; special glyph: `-|'.
  175.  
  176. `@result{}'
  177.      Indicate the result of an expression; special glyph: `=>'.
  178.  
  179.  
  180. Commands to customize headings:
  181.  
  182. `@headings ON-OFF-SINGLE-DOUBLE'
  183.      Turn headings on or off, or specify single-sided or double-sided
  184.      headings for printing.
  185.  
  186. `@evenfooting [LEFT] @| [CENTER] @| [RIGHT]'
  187.      Specify footings for even-numbered (left-hand) pages.  Not
  188.      relevant to Info.
  189.  
  190. `@evenheading, @everyheading, @oddheading, ...'
  191.      Five other related commands.
  192.  
  193. `@thischapter'
  194.      In a heading or footing, stands for the number and name of the
  195.      current chapter, in the format `Chapter 1: First Chapter'.
  196.  
  197. `@thischaptername, @thisfile, @thistitle, @thispage'
  198.      Related commands.
  199.  
  200.  
  201. Commands for formatting text:
  202.  
  203. `@cartouche'   
  204.      Draw rounded box surrounding text (not in Info).
  205.  
  206. `@enumerate OPTIONAL-ARG'
  207.      Enumerate a list with letters or numbers.
  208.  
  209. `@exdent LINE-OF-TEXT'
  210.      Remove any indentation a line might have.
  211.  
  212. `@flushleft'
  213.      Left justify every line but leave the right end ragged.  Leave
  214.      font as is.
  215.  
  216. `@flushright'
  217.      Right justify every line but leave the left end ragged.  Leave
  218.      font as is.
  219.  
  220. `@format'
  221.      Like `@example' or `@display', but do not narrow the margins or
  222.      select the fixed-width font.
  223.  
  224. `@ftable FORMATTING-COMMAND'
  225. `@vtable FORMATTING-COMMAND'
  226.      Begin a two-column table, using `@item' for each entry.
  227.      `@ftable' automatically enters each of the items in the 
  228.      first column into the index of functions and `@vtable'
  229.      enters them into the index of variables.  The commands
  230.      are the same as `@table', except for indexing.
  231.  
  232. `@lisp'
  233.      Indent text, do not fill, select fixed-width font.
  234.  
  235. `@smallexample'
  236.      Indent text, do not fill, select fixed-width font.  In
  237.      `@smallbook' format, print text in a smaller font than with the
  238.      `@example' environment.  Also, the `@smalllisp' command.
  239.  
  240. Commands for formatting if a flag is set or cleared:
  241.  
  242. `@set FLAG [STRING]'
  243.      Set FLAG, causing the Texinfo formatting commands to format text
  244.      between subsequent pairs of `@ifset FLAG' and `@end ifset'
  245.      commands.  Optionally, set value of FLAG to STRING.
  246.  
  247. `@value{FLAG}'
  248.      Replace with value to which FLAG is set.
  249.  
  250. `@ifset FLAG ... @end ifset'
  251.      If FLAG is set, the Texinfo formatting commands format text
  252.      between `@ifset FLAG' and the following `@end ifset' command.
  253.  
  254. `@clear FLAG'
  255.      Unset FLAG, preventing the Texinfo formatting commands from
  256.      formatting text between subsequent pairs of `@ifset FLAG' and
  257.      `@end ifset' commands.
  258.  
  259. `@ifclear FLAG ... @end ifclear'
  260.      If FLAG is unset, the Texinfo formatting commands format text
  261.      between `@ifclear FLAG' and the following `@end ifclear' command.
  262.  
  263. Produce unnumbered headings that do not appear in a table of contents:
  264.  
  265. `@heading TITLE'
  266.      Print an unnumbered section-like heading in the text, but not in
  267.      the table of contents of a printed manual.
  268.  
  269. `@chapheading, @majorheading'
  270. `@subheading, @subsubheading'
  271.      Related commands.
  272.  
  273.  
  274. Font commands:
  275.  
  276. `@r{TEXT}'
  277.      Print TEXT in roman font.  No effect in Info.
  278.  
  279. `@sc{TEXT}'
  280.      Set TEXT in the printed output in THE SMALL CAPS FONT and set
  281.      text in the Info file in uppercase letters.
  282.  
  283.  
  284. Miscellaneous:
  285.  
  286. `@author AUTHOR'
  287.      Typeset author's name flushleft and underline it.
  288.  
  289. `@finalout'
  290.      Prevent TeX from printing large black warning rectangles beside
  291.      over-wide lines.
  292.  
  293. `@footnotestyle STYLE'
  294.      Specify footnote style, end or separate.
  295.  
  296. `@dmn{DIMENSION}'
  297.      Format a dimension.
  298.  
  299. `@minus{}'
  300.      Generate a minus sign.
  301.  
  302. `@paragraphindent INDENT'
  303.      Specify paragraph indentation, asis or a number.
  304.  
  305. `@ref{NODE-NAME, [ENTRY], [TOPIC], [INFO-FILE], [MANUAL]}'
  306.      Make a reference.  In the printed manual, the reference does not
  307.      start with a `See'.
  308.  
  309. `@title TITLE'
  310.      Alternative format for a title page.  In the printed manual, set
  311.      a title flush to the left-hand side of the page in a larger than
  312.      normal font and underline it with a black rule.  Also,
  313.      `@subtitle' command.
  314.                
  315. `@subtitle SUBTITLE'
  316.      Subtitle in the alternative title page format.
  317.  
  318. `@today{}'
  319.      Insert the current date.
  320.